home *** CD-ROM | disk | FTP | other *** search
/ Group 42-Sells Out! - The Information Archive / Group 42 Sells Out (Group 42) (1996).iso / hack / nia / nia013.txt < prev    next >
Text File  |  1995-11-30  |  21KB  |  499 lines
  1.   ┌──────────────────┐ ╔═══════════════════════════════╗ ┌──────────────────┐
  2.   │   Founded By:    │ ║  Network Information Access   ║ │ Mother Earth BBS │
  3.   │ Guardian Of Time │─║            05APR90            ║─│  NUP:> DECnet    │
  4.   │   Judge Dredd    │ ║       Guardian Of Time        ║ │Text File Archives│
  5.   └────────┬─────────┘ ║            File 13            ║ └─────────┬────────┘
  6.            │           ╚═══════════════════════════════╝           │
  7.            │           ╔══════════════════════════════╗            │
  8.            └───────────║  VMS System Manager's Manual ║────────────┘
  9.                        ║         Chapter 03.11        ║
  10.                        ╚══════════════════════════════╝
  11.  
  12.  
  13.  
  14.                          Chapter 3  INSTALLING SOFTWARE
  15.  
  16. Any software product that you use on your system must be installed.  When you
  17. install software, the software is made available every time that the system
  18. starts up.  You must use an installation procedure for software when it is
  19. first acquired, and you must also use the installation procedure for any
  20. subsequent upgrades to the software.
  21.  
  22. On the VMS operating system, you use the command procedure
  23. SYS$UPDATE:VMSINSTAL.COM to install most software products and any upgrades.
  24. Use VMSINTAL.COM to install the most recent version of the VMS operating system
  25. and any subsequent maintenance updates, and to install many optional software
  26. products.
  27.  
  28. This Chapter describes the following:
  29.  
  30. :  How to Prepare your system for running VMSINSTAL
  31.  
  32. :  How to start VMSINSTAL
  33.  
  34. :  How to select appropriate VMSINSTAL options
  35.  
  36. :  What to do if the system fails while running VMSINSTAL
  37.  
  38. This chapter does not describe VMSINSTAL procedures that are specific to any
  39. upgrade, update, or product.  The examples used are for illustration only.  For
  40. details of a particular product, refer to the VMSINSTAL procedure described in
  41. the installation documentation for the specific product or update.
  42.  
  43. 3.1 PREPARING YOUR SYSTEM FOR VMSINSTAL
  44.  
  45. Before you use VMSINSTAL, do the following:
  46.  
  47. 1.  Back up your system disk.  Use the backup copy as a working copy for the
  48.     installation.
  49.  
  50.     If you back up your system disk to magnetic tape, you must restore the tape
  51.     to a Files-11 disk to get a working copy.  The working copy has more
  52.     contiguous space than the original system disk because of the way BACKUP
  53.     creates the copy.  You might need this additional contiguous space during
  54.     the installation.
  55.  
  56. 2.  Log in at the console terminal under the SYSTEM account ( If SYSGEN
  57.     parameters MOUNTMSG or DISMOUMSG are set to 1, OPCOM displays a message
  58.     each time a disk or tape is mounted or dismounted.  If these messages are
  59.     not disabled, and you are installing from an operator's terminal, they
  60.     appear within 30 seconds of each mount or dismount. )
  61.  
  62. 3.  Be sure that all users are logged out and that all batch jobs are
  63.     completed.
  64.  
  65. 4.  Keep users off the system using the following command:
  66.     $ SET LOGINS/INTERACTIVE=0
  67.  
  68. 5.  If your system includes it, you should shut down DECnet-VAX if DECnet-VAX
  69.     would be affected by the software product that you are installing.  To shut
  70.     down DECnet-VAX, do the following:
  71.  
  72.     A.  Start the Network Control Program ( NCP ):
  73.         $ RUN SYS$SYSTEM:NCP
  74.  
  75.     B.  At the NCP prompt ( NCP> ), enter the following command and press
  76.         RETURN:
  77.         NCP> SET EXECUTOR STATE SHUT
  78.         Decnet-VAX performs an orderly shutdown.  The opcom facility notifies
  79.         you when DECnet-VAX is shut down.
  80.  
  81.     C.  At the NCP prompt, enter EXIT and press RETURN.
  82.  
  83. 6.  Make sure the limits in the SYSTEM account authorization record are equal
  84.     to or greater than the follow:
  85.     Buffered byte count quota ( BYTLM ) = 20480
  86.     Enqueue quota ( ENQLM ) = 200
  87.     Direct I/O limit ( DIOLM ) = 18
  88.     Open file quota ( FILLM ) = 18
  89.     AST limit ( ASTLM ) = 24
  90.  
  91.     a.  To check these limits, run the Authorize Utility ( AUTORIZE ).  To
  92.         run AUTHORIZE, enter the following commands and press RETURN after
  93.         each one:
  94.  
  95.         $ SET DEFAULT SYS$SYSTEM ( RETURN )
  96.         $ RUN AUTHORIZE ( RETURN )
  97.  
  98.     b.  At the UAF ( UAF> ), enter the following command and press RETURN:
  99.  
  100.         UAF> SHOW SYSTEM ( RETURN )
  101.  
  102.     AUTHROIZE displays the current limits of the SYSTEM account's user
  103.     authorization file.
  104.  
  105. 7.  If you need to modify the current limits, enter the AUTHORIZE command
  106.     MODIFY in the following format and press RETURN:
  107.  
  108.     UAF> MODIFY SYSTEM/limit=new_value
  109.  
  110.     For example, to increase the DIOLM limit to 18, enter the following
  111.     command and press RETURN:
  112.  
  113.     UAF> MODIFY SYSTEM/DIOLM=18
  114.  
  115. 8.  When you have changed the limits, at the UAF prompt ( UAF> ) enter EXIT
  116.     and press RETURN.  This returns you to the dollar-sign prompt ( $ ).  Your
  117.     changes will not take effect until you log out and log in again.  ( See the
  118.     Reference section for a description of the commands in the Authorize
  119.     Utility. )
  120.  
  121. 9.  Physically mount the first distribution medium that contains the software
  122.     product.
  123.  
  124. 3.1.1  STARTING VMSINSTAL
  125.  
  126. This section tells you how to start VMSINSTAL and describes options that you
  127. can use.
  128.  
  129. When you start VMSINSTAL, it displays several prompts and messages that direct
  130. and explain the installation.  These prompts and messages differ, depending on
  131. the software product that you are installing.  Before you begin, make sure that
  132. you read and understand the installation procedures for the specific product or
  133. update.  If you need assistanced  during an installation, entering a question
  134. mark ( ? ) at a prompt gives you an explanation of acceptable responses.
  135.  
  136. When you start VMSINSTAL, it asks if you are statisfied with the backup of your
  137. system disk.  Make sure that the backup copy is fairly recent before you
  138. continue.
  139.  
  140. If you have not statisfied all conditions required to start VMSINSTAL, it
  141. desplays a warning message explaining the problem and a prompt asking if you
  142. want to continue.  DIGITAL strongly recommends that you correct these
  143. conditions before you try to start VMSINSTAL again.
  144.  
  145. NOTE:  If you continue without making the requrired corrections, DIGITAL might
  146. NOT support the resulting installation.
  147.  
  148. To start VMSINSTAL, enter a command in the following format and press RETURN:
  149.  
  150. $ @SYS$UPDATE:VMSINSTAL product-list source:  [OPTIONS option-list] -
  151. _$ [destination] [qualifiers]
  152.  
  153. The following sections describe the parameters and the keyword that you must
  154. supply in this command.
  155.  
  156. 3.1.1.1 SELECTING A PRODUCT-LIST
  157.  
  158. This parameter lists the products that you want to install.  If you use a
  159. wildcard character ( * ), all versions and updates of all products from the
  160. distribution media will be installed in alphabetical order.
  161.  
  162. If you want to specify more than one item in the product list parameter, you
  163. must separate the items using commas and no intervening spaces.  Specify the
  164. product list in the following format:
  165.  
  166. facvvu
  167.  
  168. fac     The product name code ( 1 to 36 alphanumeric characters )
  169. vv      The major version number ( 2 digits )
  170. u       The update number ( 1 digit )
  171.  
  172. For example, if you upgrade your operating system to VMS Version 5.2, the
  173. product name ( fac ) is VMS, the major version ( vv ) is 05, and the update
  174. number ( u ) is 2.  Therefore the porduct-list parameter is VMS052.
  175.  
  176. Using this format, you can install a specific version and update of a product
  177. form distribtuion media containing several versions and updates.  If you do not
  178. include a version or update number, all versions and updates from the source
  179. are installed in alphabetical order.
  180.  
  181. If you omit the product-list parameter, VMSINSTAL asks you for it.
  182.  
  183. If you are installing from a distribution kit, the list of products on your
  184. distribution media is included with the bill of materials for the distribution
  185. kit.  If the list is not available, enter a DIRECTORY command so that the
  186. distribution media will find the products that are included.  To obtain the
  187. product list, enter commands int he following format and press RETURN after
  188. each one:
  189.  
  190. $ MLUNT/OV=ID ddcu:
  191. $ DIRECTORY ddcu: [0,0]
  192.  
  193. Where ddcu is the drive that holds the distribution media.  If you are
  194. installing from a disk directory, obtain the product list by entering a
  195. DIRECTORY command, sepcifying the disk directory in the following format and
  196. pressing RETURN.
  197.  
  198. $ DIRECOTY node::drive:[directory]
  199.  
  200. If you are accessing a remote node, you must have READ and EXECUTE (R,E) access
  201. to the directory.
  202.  
  203. 3.1.1.2 SELECTING THE SOURCE
  204.  
  205. This parameter identifies the source of the optional software product as one of
  206. the following:
  207.  
  208. :  A drive tha holds the distribution media; for example, the RX50 drive
  209.    disignated CSA2: ona  VAX 8200.
  210.  
  211. :  A disk directory to which the product save set has been transferred from the
  212.    distribution media for later installation.
  213.  
  214.    You specify a disk directory as the source when you select the GET SAVE SET
  215.    option.  For more information about this option see Section 3.1.3.
  216.  
  217. :  A disk directory on another node.
  218.  
  219. You also can use a logical name to specify the source.  If you do not specify
  220. the source VMSINSTAL asks you for it.
  221.  
  222. 3.1.1.3  SELECTING OPTIONS.
  223.  
  224. This keyword is optional.  It precedes the list of options to be installed.  If
  225. you enter an option list without the OPTIONS keyword, VMSINSTAL displays an
  226. informational error message and the installation ends.
  227.  
  228. The options-list parameter lists the options requested.  The VMSINSTAL command
  229. procedure permits the use of five options.  You specify each option by entering
  230. the appropriate option letter after the keyword OPTIONS in the command that
  231. starts VMSINSTAL.
  232.  
  233. If you specify more than one option, do not separate the letters with spaces or
  234. commas.  For more information on choosing VMSINSTAL options see Section 3.1.3.
  235.  
  236. 3.1.1.4 SELECTING THE DESTINATION
  237.  
  238. This parameter is optional.  By default, VMSINSTAL assumes that the product is
  239. to be installed in the system-specific directory root on the system disk.
  240.  
  241. There are two instances in which you must use this parameter:
  242.  
  243. :  If you want to install the product in an alternate root.  The product is
  244.    installed on a system root other than that on which the target system is
  245.    running.  Specify the alternate system root in the following format:
  246.  
  247.    ddcu:[SYSn.]
  248.  
  249.    ddcu    --    The device on which the alternate root resides.
  250.    SYSn.   --    The top-level directory of the alternate system root.
  251.  
  252.    You also may specify a previously defined logical name for the alternate
  253.    root.
  254.  
  255. :  If you specify the GET SAVE SET option to copy the product kit save sets
  256.    into a storage directory for later installation.  For more information on
  257.    the GET SAVE SET optionj, see Section 3.1.3.
  258.  
  259.    Specify the destination directory in the following format:
  260.  
  261.    [node::]ddcu:[directory]
  262.  
  263.    node    --    a node remote from the target system ( DECnet software must be
  264.                  installed on your system to use this option.)  If you do not
  265.                  specify a node, VMSINSTAL assumes that the product save sets
  266.                  are to be stored on the local node.
  267.    ddcu    --    The destination disk device.
  268.    directory --  Usually, a directory dedicated to product save sets on the
  269.                  specified disk.
  270.  
  271. 3.1.1.5  QUALIFYING THE BACKUP COMMAND
  272.  
  273. You can specify this parameter along with the GET SAVE SET option to qualify the
  274. BACKUP command further.  The BACKUP command copies the save sets to the
  275. destination directory.
  276.  
  277. The following example includes the GET SAVE SET option and BACKUP qualifiers:
  278.  
  279. $  @SYS$UPDATE:VMSINSTAL  TEST042 DUA0: [KITS] OPTIONS G DUB0: [KITS] -
  280. _$ "/VERFIFY/LOG/CONFIRM"
  281.  
  282. 3.1.2  WHEN THE INSTALLATION IS COMPLETE
  283.  
  284. When the installation is complete, VMSINSTAL does one of the following,
  285. depending on the requirements of the product you have installed:
  286.  
  287. :  Performs an automatic shutdown of the system and instructs you to reboot
  288.    manually
  289.  
  290. :  Returns you to the dollar-sign prompt ( $ )
  291.  
  292. When the product is installed, back up the updated system disk.
  293.  
  294. 3.1.3  CHOOSING VMSINTAL OPTIONS
  295.  
  296. The VMSINSTAL command procedure permits the use of five options:
  297.  
  298. :  Auto-answer option    ( A )
  299. :  Get save set option   ( G )
  300. :  File log option       ( L )
  301. :  Release notes option  ( N )
  302. :  Alternate root option ( R )
  303.  
  304. To specify each option, do the following:
  305.  
  306. :  Enter the appropriate option letter after the keyword OPTIONS in the command
  307.    line that starts VMSINSTAL.
  308.  
  309. :  Press RETURN.
  310.  
  311. If you specify more than one option, do NOT separate the letters with commas or
  312. spaces.  For example:
  313.  
  314. $  @VMSINSTAL product source:  OPTIONS AN
  315.  
  316. 3.1.3.1  AUTO-ANSWER ( A )
  317.  
  318. The AUTO0ANSWER option makes it easier to reinstall a product by providing
  319. responses to VMSINSTAL questions and prompts during the reinstallation.  You
  320. use the AUTO0ANSWER option most often to reinstall products after an upgrade.
  321.  
  322. If you specify the AUTO-ANSWER option when you install a product, an aswer file
  323. is created in the form product.ANS in the SYS$UPDATE directory, where product
  324. is the product-list parameter that you provide when you start VMSINSTAL.
  325.  
  326. The file type of an answer file is .ANS.  The answer file contains a record of
  327. your responses to questions and prompts from VMSINSTAL.  For example, if you
  328. install the product, NEWAID, with the AUTO-ANSWER option, VMSINSTAL creates an
  329. answer file designated NEWAID.ANS.
  330.  
  331. When you reinstall the product and specify the AUTO-ANSWER option ( typically
  332. after upgrading your operating system ), VMSINSTAL reads the answer file
  333. instead of asking you questions.
  334.  
  335. If you want to create a new answer file when you reinstall a product, you must
  336. delete the existing answer file first.
  337.  
  338. 3.1.3.2  GET SAVE SET ( G )
  339.  
  340. Installing products either from a distribution tape or from console media
  341. directly onto your system disk is time-consuming.  The GET SAVE SET option
  342. saves you time by allowing you to store product save sets temorarily on a
  343. magnetic tape or in a disk directory.
  344.  
  345. You might consider dedicating a user disk on a node that other licensed system
  346. users can access.  You can store product save sets on this dedicated user disk
  347. to give other licensed system users fast access to the product save-set
  348. directory.
  349.  
  350. To store a product save set on a disk directory using the GET SAVE SET option,
  351. enter a command in the following format and press RETURN:
  352.  
  353. $  @SYS$UPDATE: VMSINSTAL product-list soruce: -
  354. $ _OPTIONS G device:[DIRECTORY]
  355.  
  356. NOTE:  The directory that you specify must exist, and the device must be
  357. mounted; VMSINSTAL does NOT perform any CREATE/DIRECTORY or MOUNT operations.
  358.  
  359. You specify the disk immediately after the OPTIONS G parameter.  For example,
  360. if you are storing save sets for a product named NEWAID from the console drive
  361. into disk directory USER1:[PRODUCTS], enter the following command and press
  362. RETURN:
  363.  
  364. $ @SYS$UPDATE: VMSINSTALL NEWAID CSA1:  OPTIONS G -
  365. $_USER1: [PRODUCTS]
  366.  
  367. VMSINSTAL creates one or more files to store the product save set in the disk
  368. directory.  The save set file name has the following format:
  369.  
  370. facvvu.x
  371.  
  372. fac    --    The product name code ( 1 to 36 alphanumeric characters).
  373. vv     --    The major version number ( 2 digits ).
  374. u      --    The update number ( 1 digit ).
  375. x      --    A literal extension that is used to identify save set files, where
  376.              A is the first save set, B the second, and so forth.
  377.  
  378. NOTE:  Valid extensions for save set files include the literal range A through
  379. Z and the numberic range VMI_0027 throught VMI_9999.
  380.  
  381. For example, suppose you are storing update 1 to Version 2.0 of the product,
  382. NEWAID, and this process requires four save sets.  VMSINTAL creates the
  383. following four files:
  384.  
  385.          NEWAID021.A
  386.          NEWAID021.B
  387.          NEWAID021.C
  388.          NEWAID021.D
  389.  
  390. When you want to install the product on your system, enter a command in the
  391. following format and press RETURN:
  392.  
  393. $ @SYS$UPDATE:VMSINTAL product-list device:[Directory]
  394.  
  395. For the product NEWAID, enter this command and press RETURN:
  396.  
  397. $ @SYS$UPDATE:VMSINSTAL NEWAID USER1:[PRODUCTS]
  398.  
  399. VMSINSTAL installs the NEWAID product on your system disk.
  400.  
  401. 3.1.3.3 FILE LOG ( L )
  402.  
  403. The FILE LOG option logs all file activity to the terminal during installation.
  404. File activity is defined as any action that alters the disposition of a file,
  405. such as creating a new file, updating a library, or deleting a file.
  406.  
  407. 3.1.4 RELEASE NOTES ( N )
  408.  
  409. Use the RELEASE NOTES option to display or print the online release notes file
  410. supplied by the layered product.
  411.  
  412. NOTE:  Not all layered products provide online release notes.
  413.  
  414. The person who builds the product kit names the release notes file.  The
  415. release notes file is given the file name facvvu.release_notes, where facvvu
  416. represents the product name code, version, and update numbers.
  417.  
  418. If release notes are available and you specify option N, VMSINSTAL asks you the
  419. following questions.  ( The default answeres are indicated in brackets ).
  420.  
  421. Release Notes OPtions:
  422.  
  423.     1.  Display release notes
  424.     2.  Print release notes
  425.     3.  Both 1 and 2
  426.     4.  Copy release notes to SYS$HELP
  427.     5.  Do NOT display, print, or copy release notes
  428.  
  429. *Select option [2]:
  430. *Queue name [SYS$PRINT]:
  431. *Do you want to continue the installation [N]:
  432.  
  433. :  The first prompt ( *SELECT OPTION ) allows you to choose options 1 - 5.
  434. :  The second prompt ( *QUEUE NAME ) Is displayed only if you select option 2
  435.    or option 3.  If you enter the name of a print queue, the system displays a
  436.    message saying that the release notes have been queued successfully to the
  437.    printer.  if you do not specify a print queue, the release notes are sent to
  438.    SYS$PRINT by default.
  439. :  The third prompt ( *DO YOU WANT TO CONTINUE THE INSTALLATION) allows you
  440.    either to continue or to end the installation.  The default is to end the
  441.    installation.
  442.  
  443. If release notes are not supplied with the product, VMSINSTAL displays two error
  444. messages.  It also asks whether you want to continue or to end the
  445. installation, as follows:
  446.  
  447. %VMSINSTAL-W-NOFILE, New File facvvu.RELEASE_NOTES does not exist.
  448. %VMSINSTAL-W-NORELNOTE, unable to locate release notes.
  449.  
  450. *Do you want to continue the installation [N]:
  451.  
  452. To continue the installation ( Whether or not release notes are available ),
  453. type Y ( for YES ) and press RETURN.
  454.  
  455. 3.1.4.1 ALTERNATE ROOT ( R )
  456.  
  457. The ALTERNATE ROOT option lets you install the product to a system root other
  458. than that of the running system.  The VMS operating system in the alternate
  459. root must be complete and the same version/update level as the running system.
  460. All files and software products that the product installation refers to must be
  461. present in the alternate root.
  462.  
  463. NOTE:  Not all optional software products allow a product to be installed to an
  464. alternate system root.
  465.  
  466. Consult the documentation of the specific product to determine whether the
  467. product can be installed to an alternate system root.
  468.  
  469. If you specify option R, the product is installed on the alternate root.
  470. However, you cannot create accounts or request a system reboot.
  471.  
  472. 3.1.5 RECOVERING FROM A SYSTEM FAILURE
  473.  
  474. If the system fails during installation of an update or optional software
  475. product, VMSINSTAL attempts to continue the installation upon rebooting.
  476. Depending on when the system failed, one of three conditions exists:
  477.  
  478. :  The system disk was not altered before the system failure.  In this case,
  479.    VMSINSTAL instructs you to restart the installation.
  480.  
  481. :  The system disk or library used by the installation was corrupted.  In this
  482.    case, VMSINSTAL instructs you to retore either the system disk or the
  483.    corrupted library from the backup copy and to restart the installation.
  484.  
  485. :  VMSINSTAL continues the installation.  In this case, VMSINSTAL performs most
  486. of the installation.  Also, it may tell you that you must perform some tasks
  487. manually to complete the installation.  If VMSINSTAL instructs you to do so, do
  488. the following:
  489.     A:  Reboot the system
  490.     B:  Log in as system manager
  491.     C:  Purge all system files that have been replaced, even if you requested
  492.         an automatic purge.
  493.         $  PURGE/LOG SYS$SYSROOT:[*...]*.*
  494.  
  495.  
  496.                                 [ END OF 03.11 ]
  497.  
  498.  
  499.